package com.eedi.framework.social.service;

import cn.binarywang.wx.miniapp.bean.WxMaPhoneNumberInfo;
import com.eedi.framework.common.enums.UserTypeEnum;
import com.eedi.framework.common.pojo.PageResult;
import com.eedi.framework.social.org.vo.client.OrgSocialClientPageReq;
import com.eedi.framework.social.org.vo.client.OrgSocialClientSaveReq;
import com.eedi.framework.social.dal.dataobject.OrgSocialClientDO;
import com.eedi.framework.social.enmus.OrgSocialTypeEnum;
import com.xingyuv.jushauth.model.AuthUser;
import me.chanjar.weixin.common.bean.WxJsapiSignature;

import javax.validation.Valid;

/**
 * 社交应用 Service 接口
 *
 * @author 永聚长青源码
 */
public interface OrgSocialClientService {

    /**
     * 获得社交平台的授权 URL
     *
     * @param socialType 社交平台的类型 {@link OrgSocialTypeEnum}
     * @param userType 用户类型
     * @param redirectUri 重定向 URL
     * @return 社交平台的授权 URL
     */
    String getAuthorizeUrl(OrgSocialTypeEnum socialType, UserTypeEnum userType, String redirectUri);

    /**
     * 请求社交平台，获得授权的用户
     *
     * @param socialType 社交平台的类型
     * @param userType 用户类型
     * @param code 授权码
     * @param state 授权 state
     * @return 授权的用户
     */
    AuthUser getAuthUser(OrgSocialTypeEnum socialType, UserTypeEnum userType, String code, String state);

    // =================== 微信公众号独有 ===================

    /**
     * 创建微信公众号的 JS SDK 初始化所需的签名
     *
     * @param userType 用户类型
     * @param url 访问的 URL 地址
     * @return 签名
     */
    WxJsapiSignature createWxMpJsapiSignature(UserTypeEnum userType, String url);

    // =================== 微信小程序独有 ===================

    /**
     * 获得微信小程序的手机信息
     *
     * @param userType 用户类型
     * @param phoneCode 手机授权码
     * @return 手机信息
     */
    WxMaPhoneNumberInfo getWxMaPhoneNumberInfo(UserTypeEnum userType, String phoneCode);

    // =================== 客户端管理 ===================

    /**
     * 创建社交客户端
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createSocialClient(@Valid OrgSocialClientSaveReq createReqVO);

    /**
     * 更新社交客户端
     *
     * @param updateReqVO 更新信息
     */
    void updateSocialClient(@Valid OrgSocialClientSaveReq updateReqVO);

    /**
     * 删除社交客户端
     *
     * @param socialClientId 编号
     */
    void deleteSocialClient(String socialClientId);

    /**
     * 获得社交客户端
     *
     * @param socialClientId 编号
     * @return 社交客户端
     */
    OrgSocialClientDO getSocialClient(String socialClientId);

    /**
     * 获得社交客户端分页
     *
     * @param pageReqVO 分页查询
     * @return 社交客户端分页
     */
    PageResult<OrgSocialClientDO> getSocialClientPage(OrgSocialClientPageReq pageReqVO);

}
